home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / critt130.zip / CRITTER.TXT < prev    next >
Text File  |  1992-03-26  |  23KB  |  521 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   CRITTER
  12.  
  13.                   A TSR replacement Critical Error Handler
  14.  
  15.                   Copyright 1990-1992 by TANSTAAFL Software
  16.  
  17.                          Version 1.30 March 26, 1992
  18.  
  19.  
  20.  
  21.  
  22.  
  23.     CRITTER is a full-featured replacement for the DOS critical error
  24.     handler.  CRITTER uses a pop-up window that does not change the
  25.     displayed program, and provides many options that DOS does not
  26.     have.  All errors can be logged to a printer.  CRITTER can use
  27.     automatic responses to an error, with a variable time delay. With
  28.     this version of CRITTER, a "response pattern" can be used to behave
  29.     in a predictable manner, such as "retry three times then fail".
  30.  
  31.     CRITTER was originally written to handle normal critical errors
  32.     with more aplomb than DOS.  It seemed that most programs back then
  33.     did not have their own critical error handlers, so any error would
  34.     ruin some of the application's display.  To this day, many
  35.     commercial applications ignore critical errors.
  36.  
  37.     According to user feedback, CRITTER really shines on systems
  38.     that are unattended.  Several users use CRITTER on their bulletin
  39.     board systems to ensure round-the-clock operations.  One user has
  40.     CRITTER running on a remote packet radio repeater.  Another user
  41.     has integrated CRITTER into a robotic manufacturing system.
  42.  
  43.     CRITTER should be installed in your autoexec.bat file, so it
  44.     can be loaded every time you boot the system.  CRITTER is not
  45.     sensitive to the order in which it is loaded with other TSR's, so
  46.     can be placed anywhere in the autoexec.bat file.
  47.  
  48.  
  49.     Command Line Options
  50.     --------------------
  51.  
  52.     CRITTER     [/U] [/M] [/S] [/Bcolors] [/Tcolors] [/Ncolors]
  53.                 [/Aresponse] [/Otimeout] [/Lprinter] [/Rresponses]
  54.                 [/Etimeticks]
  55.  
  56.         Regular Options:
  57.  
  58.         /U      Unloads the TSR.  Like all TSR's that allow themselves
  59.                 to be unloaded, this feature only works if this TSR was
  60.                 the last one loaded.  This TSR will unload correctly
  61.                 from high DOS RAM (above 640K).
  62.  
  63.         /M      Monochrome switch.  Allows correct display on systems
  64.                 with monochrome monitors connected to color display
  65.                 adapters.
  66.  
  67.         /S      Sound switch.  Turns off the beep when an error is
  68.                 detected.  Normally a beep is generated to signal
  69.                 an error.
  70.  
  71.         /B      Used to set border colors (see Color Options).
  72.  
  73.         /T      Used to set title colors (see Color Options).
  74.  
  75.         /N      Used to set normal text colors (see Color Options).
  76.  
  77.  
  78.         Advanced Options:
  79.  
  80.         /A      Enables automatic response to an error (see Automatic
  81.                 Response).  Response can be one of the following:
  82.  
  83.                 Response Action         Response Action
  84.                 ---------------         ---------------
  85.  
  86.                 A        Abort          R        Retry
  87.                 I        Ignore         F        Fail
  88.                 S        Soft reboot    H        Hard reboot
  89.  
  90.         /O      Allows user to specify the number of seconds to wait
  91.                 for a user response before triggering the automatic
  92.                 response specified by the /A option (see Automatic
  93.                 Response).
  94.  
  95.         /L      Printer log.  Allows user to specify a printer
  96.                 number to log errors to.  Valid printer numbers are 1, 2,
  97.                 or 3 and correspond to printers on LPT1, LPT2, or LPT3.
  98.  
  99.         /R      Response pattern.  Allows the user to specify a pattern
  100.                 of responses.  The normal response characters
  101.                 (A, R, I, F, S, H) can be used (see Response Patterns).
  102.  
  103.         /E      Error timer ticks.  Allows the user to specify how many
  104.                 timer ticks should pass between errors before the
  105.                 response pattern starts over (see Response Patterns).
  106.         Color Options
  107.         -------------
  108.  
  109.         Each color command is followed by characters that determine the
  110.         color to use.  Each color is designated by a single character, as
  111.         shown in the chart below.  If the character is in upper case,
  112.         it sets the background color.  A lower case character sets the
  113.         foreground color.  Adding a [+] to the string makes the fore-
  114.         ground color bright, while adding a [*] makes it blink.  Color
  115.         commands may be used in any order.
  116.  
  117.         Color           Character       Color           Character
  118.         ---------------------------------------------------------
  119.         Black           K, k            Blue            B, b
  120.         Green           G, g            Cyan            C, c
  121.         Red             R, r            Magenta         M, m
  122.         Yellow          Y, y            White           W, w
  123.         Bright          +               Blink           *
  124.  
  125.         Examples:
  126.  
  127.         /bwK            border is dim white on black
  128.         /ty+*R          title is blinking bright yellow on red
  129.         /ncB            text is cyan on blue
  130.  
  131.  
  132.         Automatic Response
  133.         ------------------
  134.  
  135.         The automatic response feature allows the user to specify a
  136.         default action and timeout duration.  If a critical error occurs
  137.         and the timeout value is specified, CRITTER shows the error
  138.         window and waits for a key to be pressed as usual (A-abort,
  139.         R-retry, etc).  The window will now contain an extra countdown
  140.         timer line.  If the user does not respond before this count
  141.         reaches zero, then the automatic response is triggered.  All
  142.         four possible responses to the error are supported (Abort, Retry,
  143.         Ignore, and Fail).  Not all errors support all responses, however,
  144.         Abort is always enabled, as is Fail on DOS versions 3.x, 4.x & 5.x.
  145.         Retry also appears to be always enabled.
  146.  
  147.         If the automatic response is enabled but the delay is not,
  148.         no error screen will be displayed and the response will take
  149.         place immediately.
  150.  
  151.         The automatic response unit can also reboot the computer as a
  152.         default response.  Either a hard (reset) or soft (Ctrl-Alt-Del)
  153.         reboot can be triggered.  This is useful for network or BBS
  154.         systems that must run unattended.
  155.  
  156.         The soft reboot feature does not work consistently on some PCs.
  157.         This seems to be caused by minor BIOS incompatibilities.  Before
  158.         relying on a soft reboot, test it once to ensure it works on
  159.         your computer.
  160.  
  161.         Examples:
  162.  
  163.         /af /o10        Wait 10 seconds for response, then fail.
  164.         /ar /o30        Wait 30 seconds for response, then retry.
  165.  
  166.         Printer Logging
  167.         ---------------
  168.  
  169.         With the printer logging feature, errors detected by CRITTER may
  170.         be logged to your printer.  This is particularly handy when used
  171.         in conjunction with the automatic response feature.  The error log
  172.         contains the same three error lines displayed when CRITTER pops up,
  173.         preceded by a header line and followed by a blank line...
  174.  
  175.             Critical Error Report from CRITTER follows:
  176.             Drive not ready
  177.             Read error on Drive A:
  178.             Located in File Allocation Table
  179.  
  180.         CRITTER only supports parallel printers.  If you have a serial
  181.         printer, try using the MODE command to route it to LPT1.  If
  182.         you try this, let us know the results.
  183.  
  184.  
  185.         Response Patterns
  186.         -----------------
  187.  
  188.         Response patterns were designed for the user who wants to retry
  189.         a fixed number of times and then do something else.  This feature
  190.         allows the user to specify up to 16 responses for an error.  Any
  191.         of the normal responses may be used.  A timeout duration (/O)
  192.         may be specified to allow a user to break out of the pattern.
  193.  
  194.         How does CRITTER know that the error it just got is the same
  195.         error it just retrie